package com.example.rssreader.common;

import lombok.Data;
import lombok.experimental.Accessors;

import java.util.List;

/**
 * 分页响应结果类
 * 用于封装分页查询的返回数据
 * 
 * @param <T> 分页数据的泛型类型
 * @author RSS Reader Team
 * @version 1.0.0
 * @since 2024-01-01
 */
@Data
@Accessors(chain = true)
public class PageResponse<T> {

    /**
     * 分页数据列表
     * 当前页的数据内容
     */
    private List<T> content;

    /**
     * 总记录数
     * 满足查询条件的所有记录数量
     */
    private Long totalElements;

    /**
     * 总页数
     * 根据每页大小计算出的总页数
     */
    private Integer totalPages;

    /**
     * 当前页码
     * 从1开始计数
     */
    private Integer currentPage;

    /**
     * 每页大小
     * 每页显示的记录数量
     */
    private Integer size;

    /**
     * 是否为第一页
     * true-是第一页，false-不是第一页
     */
    private Boolean first;

    /**
     * 是否为最后一页
     * true-是最后一页，false-不是最后一页
     */
    private Boolean last;

    /**
     * 是否有下一页
     * true-有下一页，false-没有下一页
     */
    private Boolean hasNext;

    /**
     * 是否有上一页
     * true-有上一页，false-没有上一页
     */
    private Boolean hasPrevious;

    /**
     * 私有构造函数
     * 防止外部直接实例化，强制使用静态工厂方法
     */
    private PageResponse() {}

    /**
     * 创建分页响应对象
     * 
     * @param content        分页数据列表
     * @param totalElements  总记录数
     * @param currentPage    当前页码
     * @param size           每页大小
     * @param <T>            数据类型
     * @return 分页响应对象
     */
    public static <T> PageResponse<T> of(List<T> content, Long totalElements, Integer currentPage, Integer size) {
        PageResponse<T> response = new PageResponse<>();
        response.setContent(content);
        response.setTotalElements(totalElements);
        response.setCurrentPage(currentPage);
        response.setSize(size);
        
        // 计算总页数
        int totalPages = (int) Math.ceil((double) totalElements / size);
        response.setTotalPages(totalPages);
        
        // 计算分页状态
        response.setFirst(currentPage == 1);
        response.setLast(currentPage >= totalPages);
        response.setHasNext(currentPage < totalPages);
        response.setHasPrevious(currentPage > 1);
        
        return response;
    }

    /**
     * 创建空的分页响应对象
     * 
     * @param currentPage 当前页码
     * @param size        每页大小
     * @param <T>         数据类型
     * @return 空的分页响应对象
     */
    public static <T> PageResponse<T> empty(Integer currentPage, Integer size) {
        return of(List.of(), 0L, currentPage, size);
    }

    /**
     * 判断是否有数据
     * 
     * @return true-有数据，false-无数据
     */
    public boolean hasContent() {
        return content != null && !content.isEmpty();
    }

    /**
     * 获取当前页数据数量
     * 
     * @return 当前页数据数量
     */
    public int getNumberOfElements() {
        return content != null ? content.size() : 0;
    }
}